home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / extra_2 / plotr.zip / PLOTTER.DOC < prev    next >
Text File  |  1995-10-30  |  32KB  |  547 lines

  1.                             PLOTTER INSTRUCTIONS
  2.  
  3.      PLOTTER is an ASCII data plotting and evaluation program that can be
  4.      run on any PC/AT compatible computer with at least 640K bytes of RAM
  5.      and a standard CGA, EGA or VGA color monitor. Both Epson compatible
  6.      and HP LaserJet compatible printers are supported. Screen images of 
  7.      EGA and VGA plots can be saved to disk in PCX format for importing 
  8.      to word processors. If a MOUSE is detected in the system, it is 
  9.      automatically supported.
  10.  
  11.      If you want PLOTTER to load a data file at start-up time, you can
  12.      type PLOTTER FILENAME at the DOS prompt. The file will be read
  13.      as DATA FILE TYPE #1, and the program will start at the Options
  14.      Menu (see below). The DOS command line option makes it possible to
  15.      call PLOTTER from inside your own programs. For example, in BASIC
  16.      you would include the program line: SHELL "PLOTTER FILENAME".
  17.  
  18.      In general, default input responses are indicated by an asterisk
  19.      (*). Inputs that require key strokes not followed by ENTER are
  20.      indicated by square brackets []. Inputs that require ENTER to
  21.      complete the entry are indicated by parentheses (). You can back
  22.      out of most prompts in the program by pressing the ESCAPE key.
  23.  
  24.      The use of the MOUSE is intuitive throughout the program. Place
  25.      the MOUSE CURSOR on the item to be selected and click the LEFT
  26.      BUTTON. In general, the LEFT BUTTON is treated as an ENTER key
  27.      press, and the RIGHT BUTTON is treated as an ESCAPE key press.
  28.      You can use the MOUSE to answer single key prompts, such as [Y/*N]
  29.      or F2=LABEL, but most program inputs require use of the keyboard.
  30.  
  31.      For the menus in PLOTTER, you can use the UP and DOWN ARROW keys
  32.      to scroll through the items and press ENTER for your selection.
  33.      Or you can press the highlighted "hot key." To use your MOUSE,
  34.      place the CURSOR on the desired item and click the LEFT BUTTON.
  35.  
  36.      When you start PLOTTER you will see the Main Menu, consisting of
  37.      the following selections:
  38.  
  39.                          (R)ead Data File from Disk
  40.                          Create or (E)dit Data Files
  41.                          Change Plotter (S)etup
  42.                          (I)nstructions for Plotter
  43.                          Shell to D(O)S Environment
  44.                          (Q)uit the Program
  45.  
  46.      Press the (O) key to shell to DOS, and enter "exit" to return to
  47.      PLOTTER. Press (Q), ESCAPE, or the RIGHT MOUSE BUTTON to quit.
  48.  
  49.      Pressing (I) will let you read through the instructions for PLOTTER
  50.      contained in the ASCII text file PLOTTER.DOC (which is the document
  51.      you are presently reading). Use the UP and DOWN ARROW or PAGE keys
  52.      to move through the document. Place the MOUSE CURSOR on the top or
  53.      bottom border lines and click the LEFT BUTTON to scroll up or down
  54.      one line, or place the MOUSE CURSOR on the ARROW ICONS and click the
  55.      LEFT BUTTON to move up or down one page. The (I)nstructions feature
  56.      requires PLOTTER.DOC to be in the default directory.
  57.  
  58.                          (R)ead Data File from Disk
  59.  
  60.      You will be presented with a file selection menu that allows you to
  61.      navigate to all drives and directories. Use the UP/DN ARROW KEYS,
  62.      PAGE UP/DN, HOME/END or the MOUSE CURSOR to move the highlight bar
  63.      (selecting the ".." token moves you up one directory). You can select
  64.      a data file by pressing the ENTER key, or by DOUBLE-CLICKING the LEFT
  65.      MOUSE button, on the highlighted file. When you are done, the program
  66.      will take you to the Options Menu (see below). Press ESCAPE, or the
  67.      RIGHT MOUSE button, to enter a file name manually. You will see the
  68.      prompt "Enter the FILE NAME of your DATA SET." Press ESCAPE again to
  69.      cancel the (Read) option and return to the Main Menu.
  70.  
  71.      Use this option to read your data file(s) into PLOTTER. The program
  72.      can plot up to a total of 60,000 data values (for example, 30000 X-Y
  73.      pairs in one data set). For DATA FILE TYPE #1, the number of columns
  74.      in your data file, and the length of the file, will be automatically
  75.      determined as the data is read. For DATA FILE TYPE #2, you can select
  76.      up to 9 separate data files (from the file menu only), each with
  77.      different numbers of points and different X axis values. This can
  78.      be handy for "batch" processing a group of individual files.
  79.  
  80.                          Create or (E)dit Data Files
  81.  
  82.      Use this option to manually create or edit small data files. You
  83.      will be presented with the file selection menu (see above). If you
  84.      want to create a new data file, press ESCAPE and you will get the
  85.      prompt "Enter a FILE name for your DATA SET." Press ESCAPE, or the
  86.      RIGHT MOUSE BUTTON, again to cancel. If the file name you type in 
  87.      does not exist, you will be asked if you want to create it. You are
  88.      then taken to the data editing screen.
  89.  
  90.      Use the MOUSE CURSOR to position the editing cursor, scroll the data
  91.      screen (by clicking on the ARROW ICONS or the BORDER LINES) and select
  92.      options from the bottom status bar. The editing keys are as follows:
  93.  
  94.              ARROW KEYS .......... MOVE CURSOR OR SCROLL DATA
  95.              PAGE UP/DN .......... PREVIOUS/NEXT SCREEN
  96.              HOME/END ............ START/END OF A LINE
  97.              CTRL-HOME/END ....... START/END OF THE FILE
  98.              INSERT .............. TOGGLE INSERT/TYPEOVER
  99.              ENTER ............... START A NEW LINE
  100.              TAB ................. INSERT OR TYPEOVER 5 SPACES
  101.              DEL/BACKSPACE ....... DELETE DATA AND LINES
  102.              CTRL-Y .............. CUT CURRENT LINE INTO BUFFER
  103.              SHIFT-INS ........... PASTE SINGLE LINE FROM BUFFER
  104.              CTRL-X .............. SORT DATA BY X AXIS VALUES
  105.              ESCAPE .............. SAVE FILE AND OPTIONALLY QUIT
  106.  
  107.      Enter your data according to the format shown below in the des-
  108.      cription of the Change Plotter (S)etup option. The data on each line
  109.      must be separated by AT LEAST ONE SPACE. Note that PLOTTER cannot
  110.      use more than 10 columns of data, and that the maximum file length
  111.      is about 1200 lines. Make sure that your data is entered correctly.
  112.      For example, DO NOT include commas or non-numerical characters.
  113.      Press ESCAPE, or click the RIGHT MOUSE BUTTON, to the quit editor.
  114.      You will then have the chance to save any changes you have made.
  115.      Finally, the program takes you to the Options Menu (see below).
  116.  
  117.                          Change Plotter (S)etup
  118.  
  119.      Use this option to change the default settings in PLOTTER. The new
  120.      settings will remain in effect while the current session of PLOTTER
  121.      is running. The first prompt is "Select DATA FILE TYPE to read:"
  122.      PLOTTER can read two different file formats, as shown below. The
  123.      program initially defaults to DATA FILE TYPE #1. Note that all data
  124.      files must have the data separated by AT LEAST ONE SPACE.
  125.  
  126.      DATA FILE TYPE #1: Plot up to 10 columns of data from one file.
  127.  
  128.      X1   Y11   Y12  ..  Y1m   Data columns have a common X axis and
  129.      X2   Y21   Y22  ..  Y2m   the same number of points. You can
  130.      :     :     :   ..   :    redefine the X axis column. Max size
  131.      Xn   Yn1   Yn2  ..  Ynm   for the data is 60,000 real values.
  132.  
  133.      DATA FILE TYPE #2: Plot up to 9 separate X-Y data files.
  134.  
  135.      X1   Y1
  136.      X2   Y2    Data sets can have different X axis values and numbers
  137.      :    :     of points. Max data size for ALL sets is 60,000 values.
  138.      Xn   Yn
  139.  
  140.      The next prompt is "Select [X]-Y or [S]EMI-LOG plot:" PLOTTER de-
  141.      faults to X-Y plots. Press [S] to plot the X axis values as BASE
  142.      10 LOGARITHMS. Semi-Log plots are useful for data whose X axis
  143.      values span a range from small decimals to large whole numbers.
  144.      Note that PLOTTER automatically reverts to the default X-Y plot
  145.      type when you select the Curve Fitting or Signal Processing Menus.
  146.  
  147.      The third prompt is "Show GRID LINES on plots?" You will auto-
  148.      matically get dashed grid lines on your plots indicating the
  149.      axis divisions. Press [N]o to get tick marks instead of lines.
  150.  
  151.      The final prompt is "Select maximum FFT size:" The (S)etup module
  152.      asks for the maximum FFT size, with the default being AUTO. Legal
  153.      FFT sizes for PLOTTER are integer powers of two: (256, 512, 1024,
  154.      2048, 4096, 8192, 16384). Entering the word AUTO causes the program
  155.      to select the largest FFT size that can fit your data size.
  156.  
  157.      After you have loaded your data, the Options Menu is presented:
  158.  
  159.                          (P)lot the Data Only
  160.                          (S)ignal Processing Menu
  161.                          (C)urve Fitting Menu
  162.                          Return to (M)ain Menu
  163.  
  164.      Press (M), ESCAPE, or click the RIGHT MOUSE BUTTON, to return to
  165.      the Main Menu. You can also press ESCAPE in answer to any prompt
  166.      described below to return to the Options Menu. NOTE: If you have a 
  167.      data file already loaded, and you Return to (M)ain Menu to review
  168.      the (I)nstructions or change the (S)etup, you will be returned to
  169.      the Options Menu so you can continue evaluating your data.
  170.  
  171.                          (P)lot the Data Only
  172.  
  173.      Use this option to plot your raw data. The option has slightly
  174.      different prompts for each DATA FILE TYPE.
  175.  
  176.      DATA FILE TYPE #1: You are first asked "Which COLUMN of DATA is the 
  177.      X AXIS?" The default selection is column 1. If you choose a different 
  178.      column, then all the curves will be plotted using that column as the 
  179.      common X axis. This is done by SWAPPING the current X axis column with 
  180.      the selected column while the plot is made. It is your responsibility 
  181.      to know the structure of your data so that you end up plotting the 
  182.      curves that you want. If your data file contains more than 2 columns
  183.      (X and Y), then you are asked "How many CURVES do you want to PLOT?"
  184.      The default is the total number of curves that were detected in your
  185.      data file. If you select less than the default number you are asked 
  186.      "PLOT which CURVE(S)?" Enter the column numbers you want to plot.
  187.  
  188.      DATA FILE TYPE #2: If you have read more than one data set, you are
  189.      first asked "How many CURVES do you want to PLOT?" The default is
  190.      the number of data files you have read. If you select less than the
  191.      default number then you are asked "PLOT which CURVE(S)?" Enter the
  192.      numbers of the data sets you want to plot. Recall that for this DATA 
  193.      FILE TYPE each curve can have a different X axis.
  194.  
  195.      You are then asked if the plot should "SHOW original DATA points?"
  196.      The default answer is [N]o. If you select [Y]es then small symbols
  197.      will be plotted indicating your original data. PLOTTER will pause
  198.      after showing the data points. Press ESCAPE, or the RIGHT MOUSE
  199.      BUTTON, to leave the points unconnected. Press ANY OTHER KEY, or 
  200.      the LEFT MOUSE BUTTON, to connect the points with lines.
  201.  
  202.      If you are plotting just two curves, you will be asked "Do you want
  203.      a DUAL PLOT?" The default answer is [N]o. Selecting [Y]es will plot
  204.      the first curve on the upper half of the screen and the second curve
  205.      on the lower half of the screen. Press ENTER to continue plotting
  206.      your selected curves. After the last curve has been plotted, press
  207.      ESCAPE to return to the Options Menu. See the PLOTTING OPTIONS below
  208.      for details of the features available during plotting.
  209.  
  210.      The Signal Processing Menu consists of the following options:
  211.  
  212.                          Calculate (F)FT of the Data
  213.                          (D)igitally Filter the Data
  214.                          Return to (O)ptions Menu
  215.  
  216.      Press (O), ESCAPE, or click the RIGHT MOUSE BUTTON, to return to
  217.      the Options Menu. You can also press ESCAPE in answer to any of
  218.      the prompts below to return to the Signal Processing Menu.
  219.  
  220.                          Calculate (F)FT of the Data
  221.  
  222.      PLOTTER has a valuable feature that lets you evaluate the frequency
  223.      content of time domain data, for example from a data acquisition 
  224.      system, using the Fast Fourier Transform (FFT). At least 256 data 
  225.      values are required. Also, the X axis time data must be all positive, 
  226.      and must have a constant time step.
  227.  
  228.      If you have read more than one data set, you are asked "FFT which
  229.      DATA SET?" The default is set #1. If the size of your data set
  230.      is EXACTLY the size of a legal FFT window (256, 512, 1024, 2048,
  231.      4096, 8192 or 16384 points), then the program will prompt "Select
  232.      HANNING, FLAT TOP or RECTANGULAR window: [H/F/*R]" (see below).
  233.  
  234.      If the amount of data is not an even FFT size, you will be asked to
  235.      "Select START of TIME WINDOW for NMAX point FFT," where NMAX is the
  236.      currently selected FFT size. PLOTTER will automatically select the
  237.      largest FFT that will fit your data set, unless you have specified
  238.      the FFT size in the (S)etup module. This prompt lets you tell the
  239.      program where in your data set to locate the NMAX number of points
  240.      that will be sent to the FFT subroutine.
  241.  
  242.      The final prompt is "Select HANNING, FLAT TOP or RECTANGULAR window:
  243.      [H/F/*R]." The default answer is [R]ectangular, which is the same as
  244.      applying no window. The [H]anning window is used for identifying
  245.      closely spaced frequency components in the spectrum. The [F]lat Top
  246.      window produces magnitudes in the spectrum that more accurately
  247.      show the amplitudes of the components in the original time domain
  248.      data. Consult a text on Digital Signal Processing for details.
  249.  
  250.      The time domain data is plotted on the upper half of the screen. Note
  251.      that the F6=MATH option can be used to SMOOTH or SCALE the data in the
  252.      window before computing the FFT (the original full data set is not
  253.      affected). Press Q to quit without an FFT. Press ENTER to compute the
  254.      FFT. The frequency spectrum is then plotted on the lower half of the 
  255.      screen. The PLOTTING OPTIONS are again available. Press ESCAPE, or
  256.      click the RIGHT MOUSE BUTTON, to quit the plot.
  257.  
  258.      Before you are returned to the Signal Processing Menu, you are
  259.      asked if you want to "Save FREQUENCY and MAGNITUDE values to disk?"
  260.      This allows you to store the spectrum that has just been computed.
  261.      The default answer is [N]o. If you select [Y]es, you will be asked
  262.      to "Enter a NAME for your FREQUENCY FILE." Press ESCAPE, or the
  263.      RIGHT MOUSE BUTTON, to cancel the file save option.
  264.  
  265.                          (D)igitally Filter the Data
  266.  
  267.      This feature lets you apply a LOW PASS, HIGH PASS or NOTCH filter
  268.      to your data set(s). Consult a text on Digital Signal Processing for
  269.      details. At least 256 data values are required for filtering. Also,
  270.      the X axis time data must be all positive and must have a constant
  271.      time step. Due to the numerical processing required, a maximum of
  272.      20000 Y axis data values can be filtered. If you have read more than
  273.      one data set, you are asked "FILTER which DATA SET?" The default is
  274.      set #1. The Filter Design Screen then appears.
  275.  
  276.      The first prompt is "Select LOW PASS, HIGH PASS or NOTCH FILTER:
  277.      [L/H/*N]." The default is a [N]OTCH filter, which can be used to
  278.      remove specific frequencies from your data.
  279.  
  280.      If you select a NOTCH filter, you will be asked to "Enter CENTER
  281.      FREQUENCY for FILTER: (0 to FMAX Hz)" where FMAX is one half of the
  282.      sampling frequency detected in your data. This value is the center
  283.      of the frequency range where the filter will operate. You are then
  284.      asked to "Enter BANDWIDTH for FILTER: (FRQ Hz)" where an arbitrary
  285.      default value, FRQ, is offered. This value defines the frequency range
  286.      over which the filter will operate. The NOTCH filter is a 2nd order
  287.      INFINITE IMPULSE RESPONSE (IIR) filter.
  288.  
  289.      For a LOW or HIGH PASS filter, you are asked to "Enter CUTOFF
  290.      FREQUENCY for FILTER: (0 to FMAX Hz)." This value determines the
  291.      range of frequencies to be passed. The next prompt is "Enter ORDER
  292.      of FILTER: (50)." This value determines the "rolloff" characteristics
  293.      of the filter. The PASS-type filters in PLOTTER are FINITE IMPULSE
  294.      RESPONSE (FIR) filters, and use a VON HANN window to compensate for
  295.      amplitude loss. Note that your data can be filtered multiple times
  296.      (allowing you to create, for example, a BAND PASS filter effect).
  297.      However, be aware that LOW PASS digital filtering will NOT remove
  298.      any ALIAS signals that are already in the data.
  299.  
  300.      After some processing time, you are presented with a frequency plot
  301.      showing the attenuation (in dB) of your filter. This lets you verify
  302.      that the filter will perform as expected. Press Q to quit without
  303.      implementing the filter, and return to the Signal Processing Menu.
  304.      Press ESCAPE to continue. After more processing, the filtered data
  305.      is plotted on the upper half of the screen. To let you evaluate the
  306.      spectrum of the filtered data, an FFT is computed from the first NMAX
  307.      points, where NMAX is the largest FFT size that can be fitted to the
  308.      data up to 8192 points. Press Q to quit without the FFT. Press ENTER 
  309.      to calculate the FFT and display the spectrum on the lower half of
  310.      the screen. The PLOTTING OPTIONS are then available.
  311.  
  312.      Before you are returned to the Signal Processing Menu, you are
  313.      asked if you want to "Save TIME and FILTERED DATA values to disk?"
  314.      The default answer is [N]o. If you select [Y]es, you will be asked
  315.      to "Enter a NAME for the FILTERED DATA FILE." Press ESCAPE, or click
  316.      the RIGHT MOUSE BUTTON, to cancel the file save option.
  317.  
  318.      The Curve Fitting Menu consists of the following options:
  319.  
  320.                          (C)ubic Spline Curve Fit
  321.                          (P)olynomial Curve Fit
  322.                          (A)utomatic Curve Fit
  323.                          Return to (O)ptions Menu
  324.  
  325.      Press (O), ESCAPE, or click the RIGHT MOUSE BUTTON, to return to
  326.      the Options Menu. You can also press ESCAPE in answer to any of
  327.      the prompts below to return to the Curve Fitting Menu.
  328.  
  329.      If you have read more than one data set, you are first asked "How
  330.      many CURVES do you want to FIT?" The default is the number of data
  331.      sets you have read. If you enter less than the default number,
  332.      you are asked "FIT which CURVE(S)?" You are then asked if the plot
  333.      should "SHOW original DATA points?" The default answer is [N]o. If
  334.      you select [Y]es then small symbols will be plotted indicating your
  335.      original data. PLOTTER will pause after showing the data points.
  336.      Press ESCAPE, or the RIGHT MOUSE BUTTON, to leave the points
  337.      unconnected. Press ANY OTHER KEY, or the LEFT MOUSE BUTTON, to
  338.      connect the points with the curve fit.
  339.  
  340.      If you have selected JUST ONE DATA SET for curve fitting, after the
  341.      plot of the curve fit has been presented you will be asked if you
  342.      want to "Save X and Y CURVE FIT values to disk?" The default answer
  343.      is [N]o. If you select [Y]es, you will be asked to "Enter a NAME for
  344.      the CURVE FIT DATA FILE." Press ESCAPE, or click the RIGHT MOUSE
  345.      BUTTON, to cancel the file save and return to the Curve Fitting Menu.
  346.  
  347.                          (C)ubic Spline Curve Fit
  348.  
  349.      This option will perform a CUBIC SPLINE curve fit of your data
  350.      set(s). The cubic splines will always pass through your original
  351.      data points. The most data that can be handled is 1000 points for
  352.      a single data set, or 500 points each for multiple data sets. Press
  353.      ENTER to continue plotting your selected curves. After the last
  354.      curve has been plotted, press ESCAPE to return to the Curve Fitting
  355.      Menu. Note that for this kind of curve fit, the F6=MATH option is
  356.      not available. This is because you can modify your original data
  357.      first, and then perform the curve fit. See the PLOTTING OPTIONS
  358.      below for details of the features available during plotting.
  359.  
  360.                          (P)olynomial Curve Fit
  361.  
  362.      This feature performs a least squares polynomial curve fit on your
  363.      data set(s). The most data that can be handled is 500 points per data
  364.      set. For each of the data sets you have selected, you will be asked
  365.      to "Enter the DEGREE for POLYNOMIAL #." Each data set can be fitted
  366.      with a different order polynomial. The legal range for the DEGREE
  367.      of each polynomial is from 1 to 19 (integer values).
  368.  
  369.      You can use the F6=MATH key to view the coefficients of the poly-
  370.      nomials for each data set (see the description of the PLOTTING
  371.      OPTIONS below). Press ENTER to continue plotting your selected
  372.      curves. After the last curve has been plotted, press ESCAPE, or the
  373.      RIGHT MOUSE BUTTON, to return to the Curve Fitting Menu.
  374.  
  375.                          (A)utomatic Curve Fit
  376.  
  377.      This option automatically selects the curve fit that best describes
  378.      your data set(s). The following three types of curves are used:
  379.  
  380.                         Linear:      Y = A + B * X
  381.                         Exponential: Y = A * EXP(B*X)
  382.                         Power:       Y = A * X^B
  383.  
  384.      The fit that produces the highest correlation coefficient (R^2) is
  385.      selected. The most data that can be handled is 500 points per data
  386.      set. Use the F6=MATH key during plotting to view the equation and
  387.      coefficients for the curve. For each of the selected data sets, the
  388.      best curve fit will be plotted. Press ENTER to continue plotting
  389.      your curves. After the last curve has been plotted, press ESCAPE, 
  390.      or the RIGHT MOUSE BUTTON, to return to the Curve Fitting Menu.
  391.  
  392.                             PLOTTING OPTIONS
  393.  
  394.      During plotting you can press Q to QUIT the plot screen and return
  395.      IMMEDIATELY to the previous menu. If you are plotting multiple
  396.      curves, press ENTER, or click the LEFT MOUSE BUTTON, to CONTINUE
  397.      with the next plot. After the last curve has been plotted, press
  398.      ESCAPE, or click the RIGHT MOUSE BUTTON, to QUIT the plotting screen
  399.      and return to the previous menu. You can also press the ESCAPE or
  400.      Q keys while a curve is being generated to stop the plotting.
  401.  
  402.      After each curve has been plotted, you will see a list of options
  403.      (F1 through F7) presented at the bottom of the screen. They can
  404.      be selected by the corresponding function key, or by positioning
  405.      the MOUSE CURSOR on the item and clicking the LEFT MOUSE BUTTON.
  406.      Each option contains a number of utilities.
  407.  
  408.      F1=LIMITS: You can select the upper and lower limits, and the
  409.      number of axis divisions, for both the X and Y axes. Press ENTER
  410.      alone to retain the current value. Note that you can select the
  411.      lower limits (XLOW or YLOW) to be greater than the upper limits
  412.      (XMAX or YMAX) if you so choose. If you are plotting multiple
  413.      curves, the plots will be regenerated starting at the first curve.
  414.  
  415.      F2=LABEL: This key activates one of the best features of PLOTTER.
  416.      It allows you to type ASCII text ANYWHERE on the plot screen. You
  417.      can type axis labels, plot titles, and identifying labels for your
  418.      curve(s). The cursor is originally placed above the upper left
  419.      corner of the plot. Use the ARROW keys, HOME, END, PAGE UP and PAGE
  420.      DOWN keys to move the cursor around, or you can use the MOUSE CURSOR
  421.      to position the text cursor by clicking the LEFT MOUSE BUTTON. Press
  422.      the ESCAPE key when you are done labeling. Note that the F1=LIMITS,
  423.      F3=REPLOT, F4=SINGLE and F6=MATH functions will redraw the plots and
  424.      wipe out your labels, so it's best to wait until you have the plot
  425.      just the way you like it before labeling (see the discussion of the
  426.      S and L keys below).
  427.  
  428.      F3=REPLOT: This function acts like an "oops" key. It replots the
  429.      curve(s) with the plot limits reset to the original autoscaled
  430.      values. If you are plotting multiple curves, the plots will be
  431.      regenerated starting at the first curve.
  432.  
  433.      F4=SINGLE: If you are plotting multiple curves, or have a dual plot
  434.      (as in the FFT option), this key will plot the current curve on a
  435.      single plot of its own. If you are plotting a curve fit, the plot
  436.      will be autoscaled according to the maximum and minimum values in
  437.      the curve fit. Press ESCAPE to return to the multiple curve plot
  438.      (the plots will be regenerated beginning with the first curve).
  439.  
  440.      F5=CURSOR: The data cursor function allows you to examine the
  441.      numerical values in your data. The X and Y data values of the
  442.      current curve are printed below the lower left corner of the plot.
  443.      The LEFT and RIGHT ARROW keys move the cursor. Press CTRL-ARROW
  444.      keys for a faster cursor. Alternatively, you can drag the data
  445.      cursor by holding down the LEFT MOUSE BUTTON and moving the MOUSE.
  446.      If the cursor is near a LOCAL MAXIMUM in the data, selecting
  447.      F1=LOCAL MAX will make the cursor jump to that maximum. If the
  448.      cursor is near a LOCAL MINIMUM in the data, selecting F2=LOCAL
  449.      MIN will make the cursor jump to that minimum. Each time you select
  450.      F3=STORE, the current data values are appended to an ASCII data
  451.      file that is automatically created in the default directory. For
  452.      DATA FILE TYPE #1, the file name is the prefix of your data file
  453.      with a ".CSR" extension. For DATA FILE TYPE #2, the file name is
  454.      "PLOT.CSR". Press ESCAPE to quit the data CURSOR option.
  455.  
  456.      F6=MATH: This function provides several features. If you are
  457.      plotting (P)olynomial or (A)utomatic curve fits, you will be
  458.      shown the coefficients for the current curve (the plots will then
  459.      be regenerated beginning with the first curve). The other F6=MATH
  460.      options are not allowed for curve fits since you can modify the
  461.      data first, and then perform the curve fit. S=SMOOTH will smooth
  462.      the current data set by passing it once through a five point
  463.      approximation algorithm. Data smoothing can remove jagged peaks
  464.      often caused by signal noise. X=SCALE X AXIS and Y=SCALE Y AXIS
  465.      allow you to multiply the current data set by some scaling value
  466.      (for example, multiplying by -1 would invert the plotted values).
  467.      This is especially useful for converting raw data (say volts) from
  468.      data acquisition systems to engineering units. You can also add
  469.      (or subtract) a constant offset to the data. If you are plotting
  470.      multiple curves, the plots will be regenerated starting at the
  471.      first curve. Press ESCAPE to quit the MATH option.
  472.  
  473.      F7=PRINT: This function allows you to generate hard copy of your
  474.      plots, and save EGA or VGA plot screens to disk in PCX format.
  475.      Any printers capable of emulating either an EPSON dot matrix or
  476.      a HEWLETT PACKARD LaserJet are supported for hard copy. Note that
  477.      many brands of printers can automatically emulate an EPSON printer
  478.      (the IBM laser printer is an example). The printer MUST be connected
  479.      to LPT1. The default options are H=HP LASERJET and L=LANDSCAPE.
  480.      Select H=HP LASERJET or E=EPSON to choose the printer you want (be
  481.      careful, since choosing the wrong type will cause garbage to be sent
  482.      to the printer). Select L=LANDSCAPE to print your plot sideways,
  483.      using the full paper size. Select P=PORTRAIT to print the plot
  484.      straight on using half of the paper size. When you are ready, and
  485.      the printer is turned on, select G=GO to print your plot. If you
  486.      want to save an EGA or VGA plot to disk, instead of printing, press
  487.      X=PCX. Your PCX files will be saved in the default directory with
  488.      names of the form PLOT#.PCX, where # is a number that is incremented
  489.      each time you save a screen (while the current session of PLOTTER is
  490.      running). Many word processors can import PCX files as figures into
  491.      documents. The prompt line at the bottom of the screen and the MOUSE
  492.      CURSOR are automatically blanked while the plot is being sent to the
  493.      printer or to disk. Press ESCAPE to quit the PRINT option.
  494.  
  495.      S: You are not prompted for this key, but pressing S will save all
  496.      text on the plot screen to a file called PLOT.TXT. The text can be
  497.      applied to any other plot screen by pressing L (see below).
  498.  
  499.      L: You are not prompted for this key, but pressing L will load and
  500.      display the screen text stored by the S option above. Axis numbers
  501.      and the data file name are not overwritten, but all your saved text
  502.      is restored. This is handy if you have re-plotted, or are plotting
  503.      multiple files that all require similar titles and labels.
  504.  
  505.      Q: You are not prompted for this key, but pressing Q will quit the
  506.      plot screen and return IMMEDIATELY to the previous menu. Also, you
  507.      can press Q as a curve is being generated to stop the plotting.
  508.  
  509.      RET=CONTINUE: This prompt is displayed in the lower right corner
  510.      of the plot screen. When you are plotting multiple curves, press
  511.      ENTER to continue to the next plot. After the last curve has been
  512.      plotted, the RET=CONTINUE prompt is replaced with the ESCAPE=QUIT
  513.      prompt. This keeps you from accidentally pressing ENTER too many
  514.      times and quitting the plot screen before you are ready. Recall
  515.      also that the LEFT MOUSE BUTTON is treated as an ENTER key press.
  516.  
  517.      ESCAPE=QUIT: This prompt is also displayed in the lower right
  518.      corner of the screen. The ESCAPE key is the principal means of
  519.      quitting each of the options described above. Press ESCAPE after
  520.      the last curve has been plotted to quit the plot screen and return
  521.      to the previous menu. Recall that, in general, the RIGHT MOUSE
  522.      BUTTON is treated as ESCAPE. Also, you can press ESCAPE when a
  523.      curve is being generated to stop the plotting.
  524.  
  525.                                  SHAREWARE
  526.  
  527.      PLOTTER is distributed as Shareware. Feel free to share the program
  528.      and its files with others. However, if you continue to use PLOTTER,
  529.      you must register the program by sending $15.00 US to:
  530.  
  531.                          Robert Lindsay Wells, Ph.D.
  532.                          1405 Lynn Avenue
  533.                          Clearwater, FL 34615
  534.  
  535.      When you register, you will receive the latest version of PLOTTER,
  536.      a free instruction manual, one free upgrade to any future version,
  537.      and three months of technical support by telephone or E-Mail.
  538.  
  539.                  AND FINALLY ... THE INEVITABLE DISCLAIMER
  540.  
  541.      Although all reasonable efforts have been made to ensure the
  542.      accuracy of the algorithms used in PLOTTER, the author of this
  543.      software makes no guarantee of, and takes no responsibility for,
  544.      the correctness of the plots or the data presented by PLOTTER.
  545.      Any decisions or judgements made by the user based on the plots or
  546.      data output by PLOTTER are solely the responsibility of the user.
  547.